home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Mail / pine3.92 / pico / bind.c < prev    next >
C/C++ Source or Header  |  1996-03-14  |  11KB  |  403 lines
  1. #if    !defined(lint) && !defined(DOS)
  2. static char rcsid[] = "$Id: bind.c,v 4.17 1996/03/15 07:41:11 hubert Exp $";
  3. #endif
  4. /*
  5.  * Program:    Key binding routines
  6.  *
  7.  *
  8.  * Michael Seibel
  9.  * Networks and Distributed Computing
  10.  * Computing and Communications
  11.  * University of Washington
  12.  * Administration Builiding, AG-44
  13.  * Seattle, Washington, 98195, USA
  14.  * Internet: mikes@cac.washington.edu
  15.  *
  16.  * Please address all bugs and comments to "pine-bugs@cac.washington.edu"
  17.  *
  18.  *
  19.  * Pine and Pico are registered trademarks of the University of Washington.
  20.  * No commercial use of these trademarks may be made without prior written
  21.  * permission of the University of Washington.
  22.  * 
  23.  * Pine, Pico, and Pilot software and its included text are Copyright
  24.  * 1989-1996 by the University of Washington.
  25.  * 
  26.  * The full text of our legal notices is contained in the file called
  27.  * CPYRIGHT, included with this distribution.
  28.  *
  29.  */
  30. /*    This file is for functions having to do with key bindings,
  31.     descriptions, help commands, and command line execution.
  32.  
  33.     written 11-feb-86 by Daniel Lawrence
  34.                                 */
  35.  
  36. #include    <stdio.h>
  37. #include    "osdep.h"
  38. #include    "pico.h"
  39. #include    "estruct.h"
  40. #include    "edef.h"
  41.  
  42. #ifdef    ANSI
  43.     int arraylen(char **);
  44. #else
  45.     int arraylen();
  46. #endif
  47.  
  48. /* 
  49.  * help - help function for pico (UW pared down version of uemacs).
  50.  *      this function will intentionally garbage with helpful 
  51.  *      tips and then wait for a ' ' to be hit to then update the 
  52.  *        screen.
  53.  */
  54.  
  55.  
  56. static char *helptext[] = {
  57.     "\tPico Help Text",
  58.     " ",
  59.     "\tPico is designed to be a simple, easy-to-use text editor with a",
  60.     "\tlayout very similar to the pine mailer.  The status line at the",
  61.     "\ttop of the display shows pico's version, the current file being",
  62.     "\tedited and whether or not there are outstanding modifications",
  63.     "\tthat have not been saved.  The third line from the bottom is used",
  64.     "\tto report informational messages and for additional command input.",
  65.     "\tThe bottom two lines list the available editing commands.",
  66.     " ",
  67.     "\tEach character typed is automatically inserted into the buffer",
  68.     "\tat the current cursor position.  Editing commands and cursor",
  69.     "\tmovement (besides arrow keys) are given to pico by typing",
  70.     "\tspecial control-key sequences.  A caret, '^', is used to denote",
  71.     "~\tthe control key, sometimes marked \"CTRL\", so the ~C~T~R~L~-~q key",
  72.     "~\tcombination is written as ~^~Q.",
  73.     " ",
  74.     "\tThe following functions are available in pico (where applicable,",
  75.     "\tcorresponding function key commands are in parentheses).",
  76.     " ",
  77.     "~\t~^~G (~F~1)   Display this help text.",
  78.     " ",
  79.     "~\t~^~F        move Forward a character.",
  80.     "~\t~^~B        move Backward a character.",
  81.     "~\t~^~P        move to the Previous line.",
  82.     "~\t~^~N        move to the Next line.",
  83.     "~\t~^~A        move to the beginning of the current line.",
  84.     "~\t~^~E        move to the End of the current line.",
  85.     "~\t~^~V (~F~8)   move forward a page of text.",
  86.     "~\t~^~Y (~F~7)   move backward a page of text.",
  87.     " ",
  88.     "~\t~^~W (~F~6)   Search for (where is) text, neglecting case.",
  89.     "~\t~^~L        Refresh the display.",
  90.     " ",
  91.     "~\t~^~D        Delete the character at the cursor position.",
  92.     "~\t~^~^        Mark cursor position as beginning of selected text.",
  93.     "\t\t  Note: Setting mark when already set unselects text.",
  94.     "~\t~^~K (~F~9)   Cut selected text (displayed in inverse characters).",
  95.     "\t\t  Note: The selected text's boundary on the cursor side",
  96.     "\t\t        ends at the left edge of the cursor.  So, with ",
  97.     "\t\t        selected text to the left of the cursor, the ",
  98.     "\t\t        character under the cursor is not selected.",
  99.     "~\t~^~U (~F~1~0)  Uncut (paste) last cut text inserting it at the",
  100.     "\t\t  current cursor position.",
  101.     "~\t~^~I        Insert a tab at the current cursor position.",
  102.     " ",
  103.     "~\t~^~J (~F~4)   Format (justify) the current paragraph.",
  104.     "\t\t  Note: paragraphs delimited by blank lines or indentation.",
  105.     "~\t~^~T (~F~1~2)  To invoke the spelling checker",
  106.     "~\t~^~C (~F~1~1)  Report current cursor position",
  107.     " ",
  108.     "~\t~^~R (~F~5)   Insert an external file at the current cursor position.",
  109.     "~\t~^~O (~F~3)   Output the current buffer to a file, saving it.",
  110.     "~\t~^~X (~F~2)   Exit pico, saving buffer.",
  111.     "    ",
  112.     "\tPine and Pico are trademarks of the University of Washington.",
  113.     "\tNo commercial use of these trademarks may be made without prior",
  114.     "\twritten permission of the University of Washington.",
  115.     "    ",
  116.     "    End of Help.",
  117.     " ",
  118.     NULL
  119. };
  120.  
  121.  
  122. /*
  123.  * arraylen - return the number of bytes in an array of char
  124.  */
  125. arraylen(array)
  126. char **array;
  127. {
  128.     register int i=0;
  129.  
  130.     while(array[i++] != NULL) ;
  131.     return(i);
  132. }
  133.  
  134.  
  135. /*
  136.  * whelp - display help text for the composer and pico
  137.  */
  138. whelp(f, n)
  139. {
  140.     if(term.t_mrow == 0){  /* blank keymenu in effect */
  141.     if(km_popped == 0){
  142.         /* cause keymenu display */
  143.         km_popped = 2;
  144.         if(!Pmaster)
  145.           sgarbf = TRUE;
  146.  
  147.         return(TRUE);
  148.     }
  149.     }
  150.  
  151.     if(Pmaster){
  152.     (*Pmaster->helper)(Pmaster->composer_help,
  153.                Pmaster->headents
  154.                  ? "Help on the Pine Composer"
  155.                  : "Help on Signature Editor",
  156.                1);
  157.     ttresize();
  158.     picosigs();            /* restore any altered handlers */
  159.     curwp->w_flag |= WFMODE;
  160.     if(km_popped)  /* this will unpop us */
  161.       curwp->w_flag |= WFHARD;
  162.     }
  163.     else{
  164.     int mrow_was_zero = 0;
  165.  
  166.     /* always want keyhelp showing during help */
  167.     if(term.t_mrow == 0){
  168.         mrow_was_zero++;
  169.         term.t_mrow = 2;
  170.     }
  171.  
  172.     pico_help(helptext);
  173.     /* put it back the way it was */
  174.     if(mrow_was_zero)
  175.       term.t_mrow = 0;
  176.     }
  177.  
  178.     sgarbf = TRUE;
  179. }
  180.  
  181. static KEYMENU menu_scroll[] = {
  182.     {NULL, NULL, KS_NONE},        {NULL, NULL, KS_NONE},
  183.     {NULL, NULL, KS_NONE},        {NULL, NULL, KS_NONE},
  184.     {NULL, NULL, KS_NONE},        {NULL, NULL, KS_NONE},
  185.     {"^X", "Exit Help", KS_NONE},    {NULL, NULL, KS_NONE},
  186.     {NULL, NULL, KS_NONE},        {NULL, NULL, KS_NONE},
  187.     {NULL, NULL, KS_NONE},        {NULL, NULL, KS_NONE}
  188. };
  189. #define    PREV_KEY    3
  190. #define    NEXT_KEY    9
  191.  
  192.  
  193. #define    OVERLAP    2        /* displayed page overlap */
  194.  
  195. /*
  196.  * scrollw - takes beginning row and ending row to diplay an array
  197.  *           of text lines.  returns either 0 if scrolling terminated
  198.  *           normally or the value of a ctrl character typed to end it.
  199.  *
  200.  * updates - 
  201.  *     01/11/89 - added stripe call if 1st char is tilde - '~'
  202.  *
  203.  */
  204. wscrollw(begrow, endrow, textp, textlen)
  205. int    begrow, endrow;
  206. char    *textp[];
  207. int    textlen;
  208. {
  209.     register int    loffset = 0; 
  210.     register int    prevoffset = -1; 
  211.     register int    dlines;
  212.     register int    i;
  213.     register int    cont;
  214.     register int    done = 0;
  215.     register char    *buf;
  216.     int     c;
  217.      
  218.     dlines = endrow - begrow - 1;
  219.     while(!done) {
  220.         /*
  221.          * diplay a page loop ...
  222.          */
  223.     if(prevoffset != loffset){
  224.                for(i = 0; i < dlines; i++){
  225.                 movecursor(i + begrow, 0);
  226.                 peeol();
  227.                 if((loffset+i) < textlen){
  228.             buf = &(textp[loffset+i][0]);
  229.             if(*buf == '~'){
  230.             buf++;
  231.             wstripe(begrow+i, 0, buf, '~');
  232.             }
  233.             else{
  234.             pputs(buf, 0);
  235.             }
  236.                 }
  237.             }
  238.         /*
  239.          * put up the options prompt
  240.          */
  241.             movecursor(begrow + dlines, 0);
  242.             cont = (loffset+dlines < textlen);
  243.             if(cont){                               /* continue ? */
  244.         menu_scroll[NEXT_KEY].name  = "^V";
  245.         menu_scroll[NEXT_KEY].label = "Next Pg";
  246.         }
  247.         else
  248.           menu_scroll[NEXT_KEY].name = NULL;
  249.  
  250.         if(loffset){
  251.         menu_scroll[PREV_KEY].name  = "^Y";
  252.         menu_scroll[PREV_KEY].label = "Prev Pg";
  253.         }
  254.         else
  255.           menu_scroll[PREV_KEY].name = NULL;
  256.  
  257.         wkeyhelp(menu_scroll);
  258.     }
  259.  
  260.     (*term.t_flush)();
  261.  
  262.         c = GetKey();
  263.  
  264.     prevoffset = loffset;
  265.     switch(c){
  266.         case  (CTRL|'X') :        /* quit */
  267.          case  F2  :
  268.         done = 1;
  269.         break;
  270.         case  (CTRL|'Y') :        /* prev page */
  271.         case  F7  :            /* prev page */
  272.         if((loffset-dlines-OVERLAP) > 0){
  273.                        loffset -= (dlines-OVERLAP);
  274.         }
  275.             else{
  276.             if(loffset != 0){
  277.             prevoffset = -1;
  278.             }
  279.             else{
  280.                 (*term.t_beep)();
  281.             }
  282.             loffset = 0;
  283.             }
  284.         break;
  285.         case  (CTRL|'V') :            /* next page */
  286.          case  F8  :
  287.         if(cont){
  288.                       loffset += (dlines-OVERLAP);
  289.         }
  290.         else{
  291.            (*term.t_beep)();
  292.         }
  293.         break;
  294.         case  '\016' :        /* prev-line */
  295.         case  (CTRL|'N') :
  296.           if(cont)
  297.         loffset++;
  298.           else
  299.         (*term.t_beep)();
  300.           break;
  301.         case  '\020' :        /* prev-line */
  302.         case  (CTRL|'P') :
  303.           if(loffset > 0)
  304.         loffset--;
  305.           else
  306.         (*term.t_beep)();
  307.           break;
  308.         case  '\014' :        /* refresh */
  309.         case  (CTRL|'L') :        /* refresh */
  310.             modeline(curwp);
  311.         update();
  312.         prevoffset = -1;
  313.         break;
  314.         case  NODATA :
  315.             break;
  316.         default :
  317.         emlwrite("Unknown Command.");
  318.         (*term.t_beep)();
  319.         break;
  320.     }
  321.     }
  322.     return(TRUE);
  323. }
  324.  
  325.  
  326. /*
  327.  * normalize_cmd - given a char and list of function key to command key
  328.  *           mappings, return, depending on gmode, the right command.
  329.  *           The list is an array of (Fkey, command-key) pairs.
  330.  *           sc is the index in the array that means to ignore fkey
  331.  *           vs. command key mapping
  332.  *
  333.  *          rules:  1. if c not in table (either fkey or command), let it thru
  334.  *                  2. if c matches, but in other mode, punt it
  335.  */
  336. normalize_cmd(c, list, sc)
  337. int c, sc;
  338. int list[][2];
  339. {
  340.     register int i;
  341.  
  342.     for(i=0; i < 12; i++){
  343.     if(c == list[i][(FUNC&c) ? 0 : 1]){    /* in table? */
  344.         if(i == sc)                /* SPECIAL CASE! */
  345.           return(list[i][1]);
  346.  
  347.         if(list[i][1] == NODATA)        /* no mapping ! */
  348.           return(c);
  349.  
  350.         if(((FUNC&c) == FUNC) ^ ((gmode&MDFKEY) == MDFKEY))
  351.           return(BADESC);            /* keystroke not allowed! */
  352.         else
  353.           return(list[i][1]);        /* never return func keys */
  354.     }
  355.     }
  356.  
  357.     return(c);
  358. }
  359.  
  360.  
  361. /*
  362.  * rebind - replace the first function with the second
  363.  */
  364. rebindfunc(a, b)
  365. int (*a)(), (*b)();
  366. {
  367.     KEYTAB *kp;
  368.  
  369.     kp = (Pmaster) ? &keytab[0] : &pkeytab[0];
  370.  
  371.     while(kp->k_fp != NULL){        /* go thru whole list, and */
  372.     if(kp->k_fp == a)
  373.       kp->k_fp = b;            /* replace all occurances */
  374.     kp++;
  375.     }
  376. }
  377.  
  378.  
  379. /*
  380.  * bindtokey - bind function f to command c
  381.  */
  382. bindtokey(c, f)
  383. int c, (*f)();
  384. {
  385.     KEYTAB *kp, *ktab = (Pmaster) ? &keytab[0] : &pkeytab[0];
  386.  
  387.     for(kp = ktab; kp->k_fp; kp++)
  388.       if(kp->k_code == c){
  389.       kp->k_fp = f;            /* set to new function */
  390.       break;
  391.       }
  392.  
  393.     /* not found? create new binding */
  394.     if(!kp->k_fp && kp < &ktab[NBINDS]){
  395.     kp->k_code     = c;        /* assign new code and function */
  396.     kp->k_fp       = f;
  397.     (++kp)->k_code = 0;        /* and null out next slot */
  398.     kp->k_fp       = NULL;
  399.     }
  400.  
  401.     return(TRUE);
  402. }
  403.